home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-02 / gsdb25.zip / README25 < prev   
Text File  |  1991-08-03  |  11KB  |  301 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                                     GS_DBASE
  11.  
  12.                                    Version 2.5
  13.  
  14.                                 GRIFFIN SOLUTIONS
  15.  
  16.                              dBase III, III+ access
  17.  
  18.                                  1 August 1991
  19.  
  20.                     (C) Copyright 1991 - All Rights reserved
  21.  
  22.                                 Griffin Solutions
  23.                              102 Molded Stone Place
  24.                           Warner Robins, Georgia 31088
  25.                                  (912) 953-2680
  26.                               CompuServe 75206.231
  27.  
  28.  
  29.          ---------------------------------------------------------------
  30.  
  31.         These Turbo Pascal 5.5 routines handle processing for dBase III
  32.         files, including memo (.DBT), index (.NDX), and data (.DBF) files.
  33.         Use is made of object oriented programming to simplify the user
  34.         interface.  Examples of the user interface is demonstrated in the
  35.         sample programs.
  36.  
  37.         This release is valid for reading and writing of data, index, and
  38.         memo files.
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57. --------------------------------------
  58. dBase is a trademark of Ashton-Tate
  59. Turbo Pascal is a trademark of Borland
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                                     Shareware
  67.                                     ---------
  68.  
  69.         GS_dBase is copyrighted. It is not a public domain program.  It
  70.         is being  distributed as Shareware, which means that unmodified
  71.         copies of the software and documentation may be freely copied and
  72.         shared.  We ask in return that should you find GS_dBase to be
  73.         useful, you become a registered user.  You become registered by
  74.         sending $25.00 to the address on the cover. By registering you
  75.         will get:
  76.  
  77.                 o  A copy of the latest version of the program.
  78.  
  79.                 o  Automatic notification of major program updates.
  80.  
  81.                 o  Technical support via Compuserve or by mail.
  82.  
  83.                 o  A user's manual on disk.  Sorry--printed manuals are too
  84.                    expensive at this price.
  85.  
  86.  
  87.         The shareware philosophy is to pay smaller amounts for well-
  88.         crafted and useful software from developers who cannot spend the
  89.         millions of dollars on  marketing necessary to compete with the
  90.         large software development companies.  You benefit by being able
  91.         to try a wider variety of software products to find the ones that
  92.         suit your particular purpose. And the trial is  free. The
  93.         shareware developer benefits from being able to distribute his
  94.         work to a wider audience than would be possible through normal
  95.         channels.
  96.  
  97.         Your share of the responsibility for shareware to continue, and
  98.         to support  the development of more and better products is to
  99.         distribute your shareware  programs to others and become a
  100.         registered user of those products you like and use.
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107. FEATURES
  108.  
  109. Welcome to GS_dBASE, a series of Turbo Pascal 5.5 routines for management of
  110. dBase III+ files.  The routines are designed to do the following:
  111.  
  112.   - Provide a simple user interface to read and write dBase III files.
  113.  
  114.   - Allow use and updating of index (NDX) files in reading and updating the
  115.     dBase III data (DBF) files.
  116.  
  117.   - Allow reading and updating of memo (DBT) file entries.
  118.  
  119.   - Allow creation of new dBase III files.
  120.  
  121.   - Allow creation of indexes to dBase files.
  122.  
  123.   - Provide automatic routines to display, edit, and update dBase III files.
  124.  
  125.   - Provide a file handler interface that provides a simple disk cache
  126.     capability and provision for LAN adaptability.
  127.  
  128.   - Do all of the above using only Turbo Pascal 5.5 -- no assembly routines are
  129.     used, yet speed is not sacrificed.
  130.  
  131.   - Apply Object Oriented Programming to create easily usable modules.
  132.  
  133.  
  134.  
  135. GETTING STARTED
  136.  
  137. This section will acquaint you with the files on the distribution disk and show
  138. you a demonstration to quickly see what GS_dBase can accomplish.
  139.  
  140.    Distribution Files
  141.  
  142.    The following programs should be on the accompanying disk:
  143.  
  144.         GS_DATE.PAS           Unit containing date-handling routines
  145.         GS_DB3WK.PAS          Unit for creating a dBase III file
  146.         GS_DBASE.PAS          Handles .DBF file operations
  147.         GS_DBFLD.PAS          Unit for field handling and .DBT files
  148.         GS_DBNDX.PAS          Handles .NDX file access
  149.         GS_DBTBL.PAS          Unit for creating menus from dBase fields
  150.         GS_EDIT.PAS           Unit for editing memo fields
  151.         GS_ERROR.PAS          Unit to handle error messages
  152.         GS_FILEH.PAS          Unit to process file I/O
  153.         GS_KEYI.PAS           Unit for keyboard input
  154.         GS_PICK.PAS           Unit for pulldown menus
  155.         GS_SCRN.PAS           Unit for handling the screen display
  156.         GS_SORT.PAS           Unit containing sort, compare, and swap routines
  157.         GS_STRNG.PAS          Unit to handle string manipulation
  158.         GS_WINDW.PAS          Unit to create windows
  159.         GS_WINFC.PAS          Unit to provide interface 'hook' to windows
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.         DB_XPL01.PAS          Example program - The Basic GS_dBase Program
  168.         DB_XPL02.PAS          Example program - Adding an Index
  169.         DB_XPL03.PAS          Example program - Formatting Data on the Screen
  170.         DB_XPL04.PAS          Example program - Updating dBase III Files
  171.         DB_XPL05.PAS          Example program - Automating Screen Displays
  172.         DB_XPL06.PAS          Example program - Adding Automated Update
  173.         DB_XPL07.PAS          Example program - Adding Field Menus
  174.         DB_XPL08.PAS          Example program - Functional File Update Program
  175.         DB_XPL09.PAS          Example program - Creating an Index File
  176.         DB_XPL10.PAS          Example program - Creating a dBase III File
  177.         DB_XPL11.PAS          Example program - Packing a dBase III File
  178.         DB_XPL12.PAS          Example program - Working with Fields
  179.         DB_XPL13.PAS          Example program - Using Memo Fields
  180.         DB_XPL14.PAS          Example program - Using Virtual Methods
  181.         DB_XPL15.PAS          Example program - Using the GS_Date Unit
  182.         DB_XPL16.PAS          Example program - Using the GS_Strng Unit
  183.         DB_XPL17.PAS          Example program - Using the GS_Winfc unit
  184.         DB_XPL18.PAS          Example program - Using the StatusUpdate Method
  185.  
  186.         HEALTH.DBF            dBase Test Data File 1
  187.         HEALTH.DBT            dBase Test Data File 1 Memo File
  188.         FOODNAME.NDX          dBase Test Index File for HEALTH.DBF
  189.         FOODCODE.NDX          dBase Test Index File for HEALTH.DBF
  190.         HLTHDATA.DBF          dBase Test Data File 2
  191.         HLTHDATA.NDX          dBase Test Data File 2 Index File
  192.  
  193.         GSDBLOOK.PAS          Demonstration Program
  194.         GSDBLOOK.EXE          Executable Demonstration Program
  195.  
  196.         ADDENDUM.001          Descriptions and Example Applications of
  197.                               the Latest Changes.
  198.  
  199.         READ.ME               This File
  200.  
  201.  
  202. Installation
  203.  
  204. Installation consists of copying these disks to your hard disk.  It is
  205. recommended that backup copies be made.  You will likely want to reload the
  206. database files as you 'play' with and change them while running the
  207. demonstrations.
  208.  
  209.  
  210. Demonstration
  211.  
  212. To get the feeling of the speed and features of GS_dBase, let's run the
  213. program using the HEALTH.DBF file.
  214.  
  215.      1.  Compile and run GSDBLOOK.PAS to get a feel for the ease with which
  216.          a program can be designed that allows selection, editing, and deletion
  217.          of dBase records.  If you prefer, the GSDBLOOK.EXE program may be used
  218.          instead.
  219.  
  220.      2.  Execute GSDBLOOK without any other parameters.
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.          A.  You will be presented with a selection of all .DBF files in
  228.              the current subdirectory.  Make sure HEALTH.DBF is highlighted
  229.              and press return.
  230.  
  231.          B.  Next will be displayed a list of all index files in the
  232.              subdirectory.  For now, just press Escape.
  233.  
  234.          C.  A menu consisting of options to Edit, Append, Select, Print,
  235.              Pack, and Exit will appear.  The Select option is the only one
  236.              that is not immediately obvious.  Use the cursor keys to
  237.              highlight the Select option and press return.
  238.  
  239.          D.  You will be presented with a list of field names included in
  240.              the database.  Highlight 'FOOD' and press return.
  241.  
  242.          E.  You will then be asked to provide select criteria.  For example,
  243.              To get a selection of all foods that start with 'B', you can
  244.              press 'b' and return.  For all starting with 'BR', press 'b',
  245.              'r' and return.  To get an alphabetical list of all records
  246.              press enter with the select field empty.
  247.  
  248.          F.  Highlight the food name you wish to see.  Use the home, end,
  249.              and cursor up and down arrows to select.  The record will be
  250.              displayed for editing.  As an alternative, you may append a new
  251.              record by selecting 'Append' at the end of the list.
  252.  
  253.          G.  Once the record is selected, any field may be updated.  To access
  254.              a memo field, use the cursor keys to highlight the field.  When
  255.              the field is highlighted, it will change from '-- memo --' to
  256.              ' Edit? '.  Press 'y' to call up the memo field in the editor.
  257.  
  258.          H.  When editing is complete, press F10 to exit.  Pressing [Esc] will
  259.              exit the editor without saving the changes.
  260.  
  261.          I.  You may then select another record.  Press [ESC] when done.
  262.  
  263.      3.  This program offers a choice of selecting, editing, appending,
  264.          printing, or packing records.  The printing routine allows you to
  265.          select the fields you wish to list.  When all desired fields have been
  266.          picked, press escape.  You will then be asked if you want to print the
  267.          listing.
  268.  
  269.      4.  The program may be executed with the name of the file to use on the
  270.          command line (without an extension).  For example, if you want to
  271.          edit file 'xyz.dbf' using index 'tuv.ndx' then the command is:
  272.  
  273.                GSDBLOOK XYZ TUV
  274.  
  275.          If there is no index, the second argument may be ommited.
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282. Major changes in GS_dBase Version 2.5:
  283.  
  284.      -  Dates are now handled as longint values using their Julian Date.
  285.         This simplifies date calculations.  See GS_Date unit for details.
  286.  
  287.      -  A windows interface is added to facilitate use of other window
  288.         handling packages to replace GS_Wind.  GS_Wind is renamed GS_Windw.
  289.         See GS_Winfc unit for details.
  290.  
  291.      -  Additional string handling functions have been added.  See GS_Strng
  292.         unit for details.
  293.  
  294.      -  A StatusUpdate routine is available to allow the programmer to capture
  295.         the progress of long-running routines such as Pack and IndexTo.
  296.  
  297. You may read about these upgrades in the file ADDENDUM.001, included with this
  298. library.  It may be printed by using the 'COPY ADDENDUM.001 PRN' DOS command.
  299. Your printer should be set to 12-pitch.
  300.  
  301.